Api.CreateAsync 方法

準備將程式以非同步作業方式連結到 KINGSTAR 子系統。

命名空間：IntervalZero.KINGSTAR.Local.Api

組合： IntervalZero.KINGSTAR.Local.Api (於 IntervalZero.KINGSTAR.Local.dll) 版本：4.4.0.0

語法

C#VB

public async Task<KsError> CreateAsync(
       int Instance,
       int IdealProcessor
)

Public Function CreateAsync(
       Instance As Integer,
       IdealProcessor As Integer
) As Task(Of KsError)

參數

Instance

型別：int

若您已啟動多主站套件，可選擇欲使用的 KINGSTAR Runtime 實例；若您未啟動該套件，請將其設定為零 (0)；若有三個實例而欲使用第三個，請將其設定為二 (2)，實例的數量取決於您的授權。

IdealProcessor

型別：int

設定 KINGSTAR 子系統運作的核心。子系統的所有執行緒將在給定的處理器上運作。核心零固定分配給 Windows。您可根據您的設定將其他核心分配給子系統。預設情況下，IdealProcessor 設定為零，表示 KINGSTAR 將使用實例配置表中所配置的處理器（KINGSTAR 控制台 > Runtime 設定 > 一般設定）。若該表中缺少給定實例的設定，則子系統可在 RTX64 可用的任何核心上運作。若您將 IdealProcessor 設定為其他數字，例如二，則子系統將使用核心二。

回傳值

型別：Task<KsError>

Task：代表一個非同步作業。

KsError：方法的回傳代碼。

備註

此方法應第一個被呼叫。若未先呼叫 Create 方法，則所有其他方法都會回傳錯誤。
若未啟動多主站套件，使用此方法且 Instance 設定大於零時，將回傳 errNoLicense。在沒有多主站套件的情況下，僅能將 Instance 設定為零。
多實例代表您有多個 ksRuntime.rtss 同時執行中且控制著不同的網卡，若您備有多主站套件，可使用多個 Create 來建構多個實例。例如，有三個 Create 函式，則這些函式可各自使用實例零、一和二；若沒有多主站套件，您可使用多個 Create 來建構唯一一個實例，即實例零。多個應用程式可連結到同一個 KINGSTAR Runtime，但單一應用程式不可連結到多個 KINGSTAR Runtime。
一個 KINGSTAR Runtime = 一個 ksRuntime.rtss。
Create 方法不能從執行緒集區或背景執行緒中呼叫，因為某些 RTX64 元件無法從這些位置初始化。

範例

N/A

參見

Api 類別

IntervalZero.KINGSTAR.Local.Api 命名空間